Get(ImapMessage[],ImapMessageInfo) メソッド

指定したメールボックスメッセージを取得して更新します。

シンタックス

Visual Basic (宣言)
C#

Public Overloads Function Get( _
   ByVal messages() As ImapMessage, _
   ByVal sections As ImapMessageInfo _
) As ImapMessage()

public ImapMessage[] Get( 
   ImapMessage[] messages,
   ImapMessageInfo sections
)

パラメータ

messages: このMailBoxで検索するメッセージのサブセット。
sections: 更新するメッセージセクション。

戻り値の型

取得されたImapMessageオブジェクトの配列。

例外

例外	解説
ProtocolException	サーバーから受信したIMAPプロトコル応答が不良です。

解説

指定したメッセージのセクションを取得します。このメソッドは、IMAP FETCHコマンドとUUIDを使用してメッセージコンテンツを取得します。このメソッドは一括操作に便利です。単一のメッセージを取得するには、Getを使用します。

使用例

以下のサンプルコードでは、Imapコンポーネントを使用してINBOX内のすべてのメッセージのヘッダを取得し、各メッセージの送信者、件名、および日付をリストに追加します。

private void getMessageHeaders(object sender)
{
    // サーバーとアカウントの情報を設定します。
    imap1.Session.RemoteEndPoint = new Dart.Mail.IPEndPoint(myServer, Imap.GetDefaultPort(imap1.Session));
    imap1.Session.Username = myUsername;
    imap1.Session.Password = myPassword;

    // 接続してアカウントにログインします。
    imap1.Connect();
    imap1.Authenticate();

    // メールボックスを選択します。
    imap1.SelectedMailbox = imap1.Mailboxes["INBOX"];
    // メールボックス内のすべてのメッセージのヘッダを取得します。
    imap1.SelectedMailbox.Get(imap1.SelectedMailbox.ToArray(), ImapMessageInfo.Header);

    // セッションから適切にログアウトします。
    imap1.Close();
}

private void imap1_Progress(object sender, ImapProgressEventArgs e)
{
    // プログレスバーで進行状況を表示します。
    progressBar1.Value = (int)((e.Position/e.Length)*100);

    // メッセージヘッダの情報をリストビューに表示します。
    if (e.Final)
    {
        progressBar1.Value = 0;
        string[] header = { e.Message.Message.From, e.Message.Message.Subject, e.Message.Message.Date.ToString() };
        listView1.Items.Add(new ListViewItem(header));
    }
}

Visual Basic

Private Sub getMessageHeaders(ByVal sender As Object)
    ' サーバーとアカウントの情報を設定します。
    imap1.Session.RemoteEndPoint = New Dart.Mail.IPEndPoint(myServer, Imap.GetDefaultPort(imap1.Session))
    imap1.Session.Username = myUsername
    imap1.Session.Password = myPassword

    ' 接続してアカウントにログインします。
    imap1.Connect()
    imap1.Authenticate()

    ' メールボックスを選択します。
    imap1.SelectedMailbox = imap1.Mailboxes("INBOX")
    ' メールボックス内のすべてのメッセージのヘッダを取得します。
    imap1.SelectedMailbox.Get(imap1.SelectedMailbox.ToArray(), ImapMessageInfo.Header)

    ' セッションから適切にログアウトします。
    imap1.Close()
End Sub

Private Sub imap1_Progress(ByVal sender As Object, ByVal e As ImapProgressEventArgs) Handles imap1.Progress
    ' プログレスバーで進行状況を表示します。
    progressBar1.Value = CInt((e.Position\e.Length)*100)

    ' メッセージヘッダの情報をリストビューに表示します。
    If e.Final Then
        progressBar1.Value = 0
        Dim header() As String = { e.Message.Message.From, e.Message.Message.Subject, e.Message.Message.Date.ToString() }
        listView1.Items.Add(New ListViewItem(header))
    End If
End Sub

参照

Mailbox クラス
 Mailbox メンバ
 オーバーロード一覧